Summary

Replaces the hand-rolled runCli + parseArgs in cli-e2e.test.ts (~75 lines of child_process.spawn plumbing, timeout handling, and quote-aware arg parsing) with a thin wrapper around runCli + parseArgString from @inquirerer/test. The upstream helper provides identical semantics:

• spawn with piped stdio
• capture stdout/stderr as strings
• enforce a per-call timeout (with SIGKILL)
• reject on non-zero exit code, with the captured streams attached to the error
• shell-string arg parsing that respects single/double quotes

The local runCli(args, options) keeps its existing Promise<string> signature so all 14 call sites in this file are unchanged — it just delegates the subprocess management to the upstream helper.

- import { spawn } from 'child_process';
+ import { runCli as runCliSubprocess, parseArgString } from '@inquirerer/test';

- function parseArgs(args: string): string[] { /* 20 lines */ }
- function runCli(args: string, opts): Promise<string> { /* 50 lines */ }
+ function runCli(args: string, options: { timeout?: number } = {}): Promise<string> {
+   return runCliSubprocess(TSX_BIN, [CLI_ENTRY, ...parseArgString(args)], {
+     cwd: REPO_ROOT,
+     env: { ...process.env, HOME: testHome, /* ... */ },
+     timeout: options.timeout || CLI_TIMEOUT,
+   }).then((result) => result.stdout);
+ }

Net diff: +25 / −75.

Review & Testing Checklist for Human

• Blocked on dev-utils#79 + npm publish. The runCli and parseArgString exports first appear in @inquirerer/test@1.4.x; current latest on npm is 1.3.5. This PR is filed as draft so it can be reviewed alongside constructive-io/dev-utils#79; promote out of draft once @inquirerer/test@1.4.0 (or whatever Lerna picks) is on npm and pnpm install resolves the new version.
• After the publish lands, run pnpm --filter @agentic-db/cli-e2e-tests test end-to-end against a Docker constructiveio/postgres-plus:18 + Ollama (with nomic-embed-text pulled). All 18 tests should still pass — the harness change is non-behavioral but the subprocess surface is the kind of thing that benefits from a real run.
• Confirm error formatting still looks reasonable when a CLI command fails (the upstream helper's RunCliError attaches .stdout, .stderr, .exitCode, etc. but stringifies similarly to the previous hand-rolled Error).

Notes

Companion PRs:

• constructive-io/dev-utils#79 — adds runCli + parseArgString to @inquirerer/test, plus a Testing section in inquirerer's main README pointing at the package. Must merge + publish first.
• constructive-io/constructive#1027 — drops the local re-export indirection in packages/cli/test-utils and imports directly from @inquirerer/test. Independent of this PR.

The intent across all three is to make @inquirerer/test the canonical place for both in-process Inquirerer testing (createTestEnvironment, setupTests, KEY_SEQUENCES) and out-of-process CLI E2E testing (runCli, parseArgString), so future tests don't have to re-roll the same harness patterns.

Link to Devin session: https://app.devin.ai/sessions/81001448b7c54b8099437f706d44a30d
Requested by: @pyramation